home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 26
/
Cream of the Crop 26.iso
/
os2
/
rcf2102b.zip
/
READ.ME
< prev
next >
Wrap
Text File
|
1997-06-10
|
11KB
|
264 lines
REXX Code Formatter/2 - READ.ME
---------------------------------
Welcome to REXX Code Formatter/2.
This file contains information you need to install REXX Code Formatter/2,
and additional information not included in the product documentation.
This READ.ME file is divided into the following chapters:
- REXX Code Formatter/2 Description
- REXX Code Formatter/2 Registration
- Before You Install REXX Code Formatter/2
-Software Requirements
-Hardware Requirements
- Installing REXX Code Formatter/2
- Removing REXX Code Formatter/2
- Getting Help
- Trademarks
- Release History
REXX Code Formatter/2 Description
-----------------------------------
The REXX Code Formatter/2 (RCF/2) is an OS/2(*) REXX application written
using VisPro/REXX(**) and VisPro/Reports(**). It is designed to allow a
REXX programmer to format a program in a particular style, insuring that
the format of each element of the REXX program conforms to that style.
NOTES: (1) This program makes use of the RexxUtils functions that comes
with OS/2, and it assumes they have not been removed.
(2) You do not need to have VisPro/REXX or VisPro/Reports
installed on your system to run RCF/2.
Features of REXX Code Formatter/2
---------------------------------
Using this product, users may, for example:
Define the indentation to be used in general plus the amount for:
- Program statements subordinate to DO and SELECT,
- Statements that begin with THEN/ELSE, and
- Continued statements.
Specify whether:
- Lines are to be split at semicolons,
- Redundant spaces are to be removed from program statements,
- New lines are to start before or after THEN/ELSE keywords, and
- END statements are to be indented to align with the corresponding
DO/SELECT subordinate statements.
Specify the formatting for:
- REXX keyword Instructions,
- REXX keywords besides those that begin a REXX keyword instruction,
- Variables names,
- Function names, and
- Labels.
Define special formatting for selected function names.
Check for duplicate labels and insure all labels start on a new line.
Have RCF/2 create a file of label names as they appear in the program
so that all references to them in the program (and even other
programs) will reflect this same format.
Align full-line, left-hand, and right-hand comments.
Add "commented line number" to program statements.
Generate a listing of the formatted program.
In addition, while RCF/2 is not a syntax-checker or code debugger, it
does provide some assistance in program development. It can, for
example:
Identify DO and SELECT instructions missing a corresponding END clause,
Create cross-reference information for labels, variables, and function
names,
Flag function names that might be misspelled,
Flag comments that are not started but not closed, and
Highlight literal strings with a missing quote.
REXX Code Formatter/2 Registration
------------------------------------
This program is SHAREWARE. The registration fee is $15 U.S. per copy.
To register your copy of REXX Code Formatter/2 and receive your
Registration Key, order RCF/2 from RKE Consulting, Inc., or BMT Micro.
For BMT Micro orders, see the BMTORDER.TXT file which is contained in
this package, or refer to the "Registration" section found in the
RCF/2 on-line help facility.
To order from RKE Consulting, Inc., send $15 per copy (Texas
residents, please send $16.09 per copy) drawn on a U.S. bank to:
RKE Consulting, Inc.
P.O. Box 11569
Spring, TX 77391-1569
Please indicate whether you would like your Registration Key sent by
normal mail (i.e., snail-mail) or E-mail, and include the address to
be used.
Before You Install REXX Code Formatter/2
------------------------------------------
Software Requirements
---------------------
IBM Operating System/2(*) (OS/2) Warp 3.x. or higher
Hardware Requirements
---------------------
- A personal computer that runs OS/2 Warp 3.0 or higher
- 1MB of fixed disk space above that required by OS/2
Installing REXX Code Formatter/2
----------------------------------
If you have received In RCF/2 on a diskette, skip to step 2.
STEP 1: If you have down-loaded or received RCF/2 as a ZIP file,
you will need to use the PKZIP(r) software by Pkware, Inc. To
perform this step, do the following:
A. Obtain a copy PKUNZIP.EXE to unpack the file. This
program is readily available on most BBS's and FTP's
sites.
B. Make the directory containing the RCF2.ZIP file the
default directory. At the OS/2 command prompt, enter the
command:
PKUNZIP RCF2nnnn.ZIP
Where "nnnn" is a suffix. (This suffix is associated with
the release of RCF/2. The higher suffix being the later
release of the program.)
STEP 2: If installing from diskette, place the distribution
diskette in your diskette drive.
STEP 3: At the OS/2 prompt, enter one of the following:
A. If installing from diskette on drive A, enter:
A:\INSTALL
B. If installing from diskette on drive B, enter:
B:\INSTALL
C. If installing from a fixed disk (for example, the
directory where RCF2nnnn.ZIP has been "unzipped"),
enter the full path to the INSTALL.EXE program.
To illustrate, if the RCF/2 package has been placed
in the "TEMP" directory on the "C:" drive, enter:
C:\TEMP\INSTALL
STEP 4: Answer the installation program questions.
STEP 5: When complete, an RCF/2 program icon will appear
on your desktop. (You may move it to any convenient place.)
Double-clicking the program icon will start RCF/2.
See the RCF/2 help introduction for more information about
getting started with RCF/2.
Removing REXX Code Formatter/2
--------------------------------
To remove the installation of RCF/2, do the following:
STEP 1: Run the RCF/2 installation procedure and select:
Delete the installed product and re-install
STEP 2: After the deletion is complete, exit the install
procedure without doing the re-install.
Getting Help
------------
Documentation
- Documentation is provided through the RCF/2 Help facility.
Please review the on-line help "Introduction" for valuable
information about support, limitations, and future enhancements.
Service and Technical Support
- Technical support is free to all registered users of RCF/2.
Questions and problems should be sent via E-mail Inc. to
rkeinc@ibm.net, or faxed to RKE Consulting, Inc. at
281-370-9842. Please write in English, and include a return
address where we may respond.
Defect Reporting
- If you believe that you have found a defect in RCF/2, please
report it to the Technical Support using the procedure described
in the on-line help for "Support" which is a sub-chapter of the
"Introduction."
Trademarks
----------
(*) IBM and OS/2 are trademarks of the International Business
Machines Corporation.
(**) VisPro/REXX and VisPro/Reports are trademarks of HockWare, Inc.
Release History
---------------
Release 1.1.0 Initial release.
Release 1.1.1 A maintenance modification release to correct various
bugs and problems found in the initial RCF/2 release,
primarily caused by the differences between Warp 3 and 4.
This release includes:
- Fixes to eliminate loading problems when running under
OS/2 Warp 3 with classical REXX and Warp 4 with Object
REXX.
- Correction to incorrect program listing output.
- Corrections to miscellaneous help panels.
- Modifications to some notebook pages to accommodate
differences between Warp 3 and Warp 4.
- Elimination of a bug that could cause two settings
notebooks to be open at the same time.
Release 1.1.2 Corrected an error that could prevent an editor from being
properly configured and invoked.
Release 1.2.0 New product release. This release adds:
- A cross reference facility for labels, variables, and
function names.
- Optional formatting notes if undefined function names are
found.
- The ability to add "Commented line numbers" to statements.
- Landscape printing formats.
- Right-hand alignment of full-line comments with extension
and truncation to allow for "boxing" of comments.
- Specification of file name and directory for generated
associated label files.
- Maintenance of multiple generated associated label
file data in a single file.
- Separate formatting specification for the standard REXX
built-in functions.
- The specification of the file to be edited as a parameter
at RCF invocation.
- The extension of the allowable indentation values to be up
to 999.
- Placement of the print specification in a separate page to
facilitate changing of printer specifications.
- Use of Warp 4 notebook format for configuration settings
when using OS/2 Warp 4.
Release 1.2.1 A maintenance release to correct the following:
- Missing function names in the internal function names
tables.
- Corrected print menu selection options.